Skip to content

docs: Add CLI direct shortcuts and machine-mode flag#1753

Open
claudespice wants to merge 1 commit into
trunkfrom
docs/cli-direct-shortcuts-and-machine-mode
Open

docs: Add CLI direct shortcuts and machine-mode flag#1753
claudespice wants to merge 1 commit into
trunkfrom
docs/cli-direct-shortcuts-and-machine-mode

Conversation

@claudespice
Copy link
Copy Markdown
Collaborator

Summary

Documents three user-visible CLI additions introduced in spiceai/spiceai#10815:

  • Top-level direct shortcuts spice -sql <query> and spice -p <prompt> / spice -chat <prompt> for one-shot SQL and chat invocations without typing the subcommand.
  • Global --machine (alias --programmatic) flag for JSON-output / structured-error mode, intended for LLM agents and CI automation.

Source PRs

Changes

  • website/docs/cli/index.md
    • New "Direct Command Shortcuts" section with a table of shortcut → equivalent mappings and example invocations.
    • New "Machine-readable Mode" section explaining --machine / --programmatic semantics, position-agnostic behavior, and JSON defaulting for supported subcommands.

Test plan

  • cd website && npm run build passes locally (Docusaurus throws on broken links and undefined frontmatter tags)
  • Verified shortcut behavior against bin/spice/src/main.rs::normalize_direct_shortcut_args (-sqlsql --query, -p/-chatchat --direct-prompt)
  • Verified --machine/--programmatic global flag definition at bin/spice/src/main.rs:122-123 and machine-mode dispatch in apply_machine_mode

Documents top-level shortcuts (-sql, -p / -chat) and the global
--machine / --programmatic flag introduced in spiceai/spiceai#10815.

Source: spiceai/spiceai#10815
@claudespice claudespice self-assigned this May 20, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 20, 2026

✅ Pull with Spice Passed

Passing checks:

  • ✅ Title meets minimum length requirement (10 characters)
  • ✅ Has at least one of the required labels: area/blog, area/docs, area/cookbook, dependencies
  • ✅ No banned labels detected
  • ✅ Has at least one assignee: claudespice

@github-actions
Copy link
Copy Markdown

🔍 Pull with Spice Failed

Passing checks:

  • ✅ Title meets minimum length requirement (10 characters)
  • ✅ Has at least one of the required labels: area/blog, area/docs, area/cookbook, dependencies
  • ✅ No banned labels detected

Failed checks:

  • ❌ At least one assignee is required for this pull request.

Please address these issues and update your pull request.

@github-actions
Copy link
Copy Markdown

🚀 deployed to https://e3ba5828.spiceai-org-website.pages.dev

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant